Obtains a control’s current reference value.

SInt32 GetControlReference (
    ControlRef theControl
);

theControl

A handle to the control whose current reference value you wish to determine.

function result

The current reference value for the specified control.0

DISCUSSION

When you create a control, you specify an initial reference value, either in the control resource or in the refCon parameter of the function NewControl. The reference value is stored in the contrlRfCon field of the control structure. You can use this field for any purpose, and you can use the function SetControlReference to change this value.

AVAILABILITY

Supported in Carbon. Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.

© 2000 Apple Computer, Inc. — (Last Updated 5/8/2000)